home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir24 / mb1705.zip / INSTALL.DOC < prev    next >
Text File  |  1994-05-23  |  32KB  |  736 lines

  1. INSTALL.DOC
  2.  
  3. This  document is intended to be a guide for installing the Packet Radio
  4. BBS program developed by:
  5.  
  6. Hank Oredson, W0RLI.
  7. 21390 Shannon Lane
  8. West Linn, OR 97068
  9.  
  10. It will look at the intallation of the software on your computer system from
  11. the aspect of an upgrade and a complete new install. These instructions are at
  12. the end of this document.  This document is based on Version 17.x  but will
  13. include instructions for upgrading from previous versions of W0RLI.  It also
  14. assumes that you have a working knowledge of QuarterDeck' DesqView and QEMM
  15. programs and DOS.
  16.  
  17. REGIONAL COORDINATORS
  18.  
  19. Several people have kindly volunteered to act as regional coordinators for
  20. questions, bug reports, etc.  These are as of this writing:
  21.  
  22. G4WPT @ GB7BNM        -     For the U.K.
  23. JA1KSO @ JA1KSO     -     For Japan and the Far East
  24. LU3AGJ @ LU3AGJ     -     For Latin America
  25. VE3GYQ @ VE3GYQ     -     For North America
  26.  
  27. N6IYA    @  N6IYA    -     For  North  America.    This   major distribution
  28.              point and can provide the software on any flavor of
  29.              5 1/4 or 3 1/2 floppy disk. The mailbox software is
  30.              more than 360k in size so if 360k diskettes are
  31.              required please send two.
  32.              Send a SASE diskette mailer and formatted diskettes
  33.              to:
  34.              John Smith, N6IYA
  35.              1060 Pine Drive
  36.              Felton, CA  95018
  37.              Dial up services are available upon request.  Contact
  38.              John @ (408) 335-2034
  39.              Releases are sent to N6IYA for test and release and
  40.              then are uploaded to:
  41. WA6RDH    @ WA6RDH     WA6RDH dialup system @ (916)  678-1535
  42.  
  43. CompuServe         Compuserve Hamnet Forum - Software Library
  44.  
  45. OPERATING ENVIRONMENT
  46.  
  47. This Mailbox runs under DOS or OS/2 in conjunction with DESQView.   The
  48. mailbox will also run multiple copies in the above mentioned multi-tasking
  49. environments.  In its present interation it will require that the system run
  50. in conjuntion with G8BPQ's switch software and the TNC's in the KISS mode.
  51. It is possible to run up to 24 tasks and 20 Ports and all common  files to
  52. the mailbox will be shared.  Starting with version  16.0  many of the common
  53. functions were moved to SERVER resutlting in a smaller MB.EXE task but a
  54. larger SERVER task.  In version 17.x many of the tasks that were once handled
  55. by MB.EXE have now been moved to additional program files that handle specific
  56. types of system tasks.    The result is a modular system, smaller and faster
  57. executable files and a smaller SERVER.EXE.
  58.  
  59.  
  60.                    (1)
  61. FILE STRUCTURE
  62.  
  63. Most of the files used by the Mailbox are can now be set to reside in seperate
  64. directories.  The only thing that is currently hardwired is the message files
  65. themselves.  These must reside in the \BBS directory.  The remaining files
  66. are placed into directories and are used in accordance with the enviornmental
  67. variables as described below. (See OTHER FILES below for more details.)
  68.  
  69. ENVIRONMENTAL VARIABLES
  70.  
  71. The executable files (.EXE and .COM) can be placed in a separate
  72. sub-directory.     The easiest installation is to place all the Mailbox files
  73. into the \BBS directory.  Any remaining file structure will be created upon
  74. startup of the system based on the entries in DIRS.MB.
  75.  
  76. Starting in version 16.8 environmental variables can be setup in your
  77. autoexec.bat file that allow the placement of the various config files,
  78. database files, log files and temporary files into their own subdirectories
  79. to speed up the system processing.  See OTHER FILES below for more details.
  80.  
  81. SYSTEM REQUIREMENTS
  82.  
  83. The minimum system requirements that are needed are:
  84.  
  85.     It is recommended that the code be run on a 386 or better.
  86.  
  87.     The number of ports, port speed and the number of tasks that can be
  88.     run depend on the speed of the system and the amount of memory that
  89.     you have.  Assuming a 1200 baud Radio data  rate, 9600 baud TNC to
  90.     computer data rate the following guidelines apply:
  91.  
  92.     On a fast 386 with 4mb of memory at least 8 ports with 12 tasks has
  93.     been tested.
  94.  
  95. SYSTEM FILES
  96.  
  97. The following files are required to be present for the system to function
  98. correctly:
  99.  
  100. MBUSER.EXE    -    The User interface to the Mailbox
  101.  
  102. MBSYSOP.EXE    -    The Sysop interface to the Mailbox
  103.  
  104. MBFWD.EXE    -    The Forwarding system of the Mailbox
  105.  
  106. MBLISTEN.EXE    -    The system watchdog. Watches ports and hands off the
  107.              task to the appropriate interface.
  108.  
  109. SERVER.EXE    -    The server function.  This is a general server interface
  110.              and must be running at all times for the system to
  111.              function.    All functions such as forwarding and
  112.              housekeeping events are controlled by SERVER.EXE.
  113.              Server has a command line option that controls which
  114.              events are displayed in the Server window.  Setting the
  115.              option turns off the the display of these events.
  116.              To turn off the display of message and login/logout events
  117.              use "SERVER LM".  The LM would be placed on the optional
  118.              parameters line in the DesqView window that calls SERVER
  119.              .EXE.
  120.                     (2)
  121.  
  122.              The classes of events that are displayed in the SERVER
  123.              window are:
  124.              c - Cron events
  125.              h - Housekeeping events
  126.              l - Login/Logout events
  127.              m - message events
  128.              s - Server activations
  129.  
  130. MBINIT.EXE    -    The Mailbox initialization program.  The program loads
  131.              global data into LM, checks that the TNC's are alive and
  132.              provides other startup functions.    This must be run
  133.              prior to Desqview.
  134.  
  135. LM.COM        -    The  Mailbox "Lock Manager", which becomes resident at
  136.              system startup and provides various services to the
  137.              MailBox.  This program must be loaded prior to the start
  138.              of DesqView and prior to running MBINIT.
  139.  
  140. YTNC.COM    -    G8BPQ backend.  Required to run system.  (See YTNC.DOC
  141.              for configuration information.)  Must be run prior to
  142.              running DesqView and after running BPQCODE.
  143.  
  144. BPQCODE.EXE    -    G8BPQ switch interface to your KISS TNC's.  This is the
  145.              required interface for your com ports and must be run
  146.              prior to DesqView and MBINIT.
  147.  
  148. MBSTAT.EXE    -    A separate function that can be run in its own Desqview
  149.              window.  It provides a running display of current
  150.              MailBox activity.
  151.  
  152. OPTIONAL FILES
  153.  
  154. NW.EXE        -    The Netwalker.  A tool for tracing connectivity of a
  155.              NET/ROM or TheNet network.
  156.  
  157. RECOVER.EXE    -    Message and user database recovery program.  To ONLY be
  158.              used in the event of a system crash.
  159.  
  160. PRTLOG.EXE    -    The MailBox log file  analyzer.  Will produce summary
  161.              reports of the mailbox activity.
  162.  
  163. WPOPT.EXE    -    WP database optimizer.  Will sort the WP.MB file which
  164.              will make some WP database queries faster.
  165.  
  166. WPSTAT.EXE    -    Provides some statistics on the WP database sturcture.
  167.              It is mainly used to provide diagnostic information.
  168.  
  169. SHAKE.EXE    -    Executable files used to maintain the "cookie" database.
  170. BAKE.EXE
  171. TAKE.EXE
  172.  
  173. FT.EXE        -    File transfer utility.  Is a small add on and is called
  174.              as a G8BPQ Application.  Will transfer executable files
  175.              without conversion.  See FT.DOC for information.
  176.  
  177. HLOC.EXE    -    A Hierarchial Location utility.  Does a dump of the WP.MB
  178.              file and displays calls seen at different H Addresses.
  179.  
  180.                     (3)
  181.  
  182. RT.EXE        -    Round Table utility.  Allows users to converse directly
  183.              with other users in a round  table type fashion.  This is
  184.              also called as a G8BPQ Application.  See RT.DOC for
  185.              information.
  186.  
  187. MON.EXE     -    Monitor utility.  Run as a separate window under DesqView.
  188.              This utility allows the monitoring of channel activity.
  189.  
  190. PRTBPQ.EXE    -    A G8BPQ utility that displays information on the
  191.              activity and current status of the G8BPQ Switch.  Used
  192.              mainly as a diagnostic tool.
  193.  
  194. CVTMB.EXE    -    Utility to convert the database files to a new format
  195.              when it is required because of new database changes.
  196.              When installing new version run this program before
  197.              starting system.
  198.  
  199. WPLOAD.EXE    -    Utility to load wp information from a text file.
  200.  
  201. SERVERS          See SERVER.DOC for more information on SERVERS.
  202.  
  203. ECHO        -    Created by W0RLI, returns a message.
  204. FILEX        -    Created  by  W0RLI,  provides  REQFIL, REQDIR and upload
  205.              functions.
  206. LSTSRV        -    Created by W0RLI, general mail exploder.
  207. REQCB        -    Created by W0RLI, for the J-COMM and RT Systems Callbook
  208.              databases.
  209. REQDIR        -    Created by WB3AFL, Directory retreival server.
  210. REQFIL        -    Created by WB3AFL, File retreival server.
  211. REQWP        -    Created by W0RLI, remote queries to WP database.
  212. SMTP        -    Created by K3MC, provides Mailbox/SMTP message
  213.              interchange.
  214. REDIST        -    Created by W0RLI, Message Redistribution server.
  215.  
  216. CONFIGURABLE FILES
  217.  
  218. The Placement of these files is under control of environmental variable RLICFG.
  219. See the OTHER FILES section below for more information.
  220.  
  221. PORTS.MB    -    MailBox port configuration file.  Defines how ports are
  222.              to behave once the system has started.  This is a
  223.              required file and must be edited for your system.    It is
  224.              read and loaded by MBINIT.EXE.
  225.  
  226. INIT.MB     -    MailBox initalization file.  Contains the system
  227.              information that is date dependent, wp update path and
  228.              various system parameters.  This is a required file and
  229.              must be edited for your system.  It is read by MBINIT.EXE.
  230.              Removal of the lines in this file will result in the
  231.              system not running properly.
  232.  
  233. MOTD.MB     -    User login file.  Contain the user login greeting.  It
  234.              is a required file.  It must be edited for your system
  235.              and can contain globals.
  236.  
  237. NEWUSER.MB    -    Contains message text file for new user upon first login
  238.              to the MailBox.
  239.  
  240.                     (4)
  241. INFO.MB     -    Contains information on the system and is retreived by
  242.              the I command from the MailBox prompt.
  243.  
  244. XLATE.MB    -    Translation file that contains information on different
  245.              types and classes for messages and how to process them.
  246.              Contains information on Bulletin time-to-live, Holds,
  247.              Translations, messages to file and message readdress.
  248.              See SYSOP.DOC for information.
  249.  
  250. DIRS.MB     -    File that contains information on various subdirectories
  251.              below \BBS for files and how these directories can be
  252.              accessed.    See SYSOP.DOC for information.
  253.  
  254. TEXT.MB     -    The file that contains the various prompts and messages
  255.              that the user and sysop will see.    It is a required file
  256.              and can be edited to suit your site.  Do not eliminate
  257.              any lines from this file.    All are required. See SYSOP
  258.              .DOC for information.
  259.  
  260. FWD.MB        -    The forwarding file.  Contains information on who and
  261.              what you intend to forward to other systems.  Completely
  262.              configurable.  See SYSOP.DOC for information.
  263.  
  264. CRON.MB     -    The event timer file.  This file is required in order
  265.              for the system to perform any housekeeping or forwarding.
  266.              This file is intimately tied to SERVER.EXE and  FWD.MB
  267.              and  directs  the SERVER on when to perform the various
  268.              MailBox tasks.  See SYSOP.DOC for information.
  269.  
  270. SERVER.MB    -    SERVER Configuration file.  Calls the various servers
  271.              based upon the type of server being used.    User
  272.              configurable and each type is seperated by a blank line.
  273.              See SYSOP.DOC for information.
  274.              Server is responsible for the processing of incoming
  275.              messages.    Once a message is received SERVER.MB is
  276.              scanned for any processing of the message that is needed
  277.              and then directs the appropriate server to immediately
  278.              commence that processing.
  279.  
  280. DIST.MB     -    Message distribuiton file.  Contains information on type
  281.              of message to be distributed and to which callsign or
  282.              callsigns.  Can be completely configured for your
  283.              location and eliminates the need to place flood
  284.              designators in FWD.MB.
  285.  
  286. FTUSERS.MB    -    The  file    that  contains    priviledge information for
  287.              users of the file transfer utility.
  288.  
  289. TAG.MB        -    The file that contains tag lines for messages that are
  290.              received by callsign, sent by the sysop or to a callsign.
  291.  
  292. KEYS.MB     -    Defines sysop users, priviledges and passwords if
  293.              required for remote sysop activity.  Can also be used to
  294.              provide security for user access.
  295.  
  296. HELP.MB     -    The file containing the various help texts when called
  297.              from the MailBox command line.  Can be modified to suit
  298.              your location or users.
  299.  
  300.                     (5)
  301.  
  302. REDIST.MB    -    The file containing the definitions of the distribution
  303.              domains at this system.  Defines locbbs, local, region and
  304.              nation domains for the redistribution of messages.
  305.  
  306. NON-CONFIGURABLE FILES
  307.  
  308. The placement of these files is under control of environmental variable RLIDB.
  309. See the OTHER FILES section below for more information.
  310.  
  311. MAIL.MB     -    Mail file database.  Is created by the system and is not
  312.              user configurable.
  313.  
  314. WP.MB        -    WP (White Pages) database file.   This file contains the
  315.              user addresses and information.  It is created by the
  316.              system and is updated by user login, message receipt or
  317.              update by other WP Update files.  The information can be
  318.              editied by the sysop from the Mailbox command prompt.
  319.  
  320. LOGIN.MB    -    File containing callsigns of logins to the system.
  321.              Viewed by the J command from the MailBox command line.
  322.  
  323. BID.MB        -    File containing the BID's (Bulletin Identifer's) of
  324.              messages received by the system.  This file is reviewed
  325.              by the system upon presentation of a message and
  326.              determines whether it has seen the file before based upon
  327.              its presented BID.  A parameter in INIT.mb determines
  328.              how long BIDS are held by the system.
  329.  
  330. The placement of these files is under control of environmental variable RLILOG.
  331. See the OTHER FILES section below for more information.
  332.  
  333. YYMM.LOG    -    Log files.  Created by the system that records the events
  334.              happening in the system.  The files are created upon
  335.              opening a new Mailbox task.  The files are named based on
  336.              the Year and month.  These new log files contain all the
  337.              information for all events of the system in a single file.
  338.  
  339. OTHER FILES
  340.  
  341. TEMPORARY FILES
  342.  
  343. The placement of these files is under control of environmental variable RLITMP.
  344.  
  345. There are the various temporary files used by the MailBox.  These files will
  346. reside in the \TMP or other directory as directed by the environmental
  347. variable RLITMP.  These files are files that are used by the system to import
  348. and export the various type of files as they are processed by the system.
  349. Examples of these are import/export files used by the server.
  350.  
  351. CONFIG.SYS    -    Your system config.sys file.  It will be necessary to add
  352.              parameters to this file so that the system can handle the
  353.              Mailbox.
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.                     (6)
  361.              The recommended parameters are:
  362.              Files=70       Roughly 8 - 10 per open window.
  363.              Buffers=60    Set this as required by the cache that you
  364.                    use.
  365.              Stacks=9,256  You may need 16,64, 0,0 or 8,128 depending
  366.                    on your DOS version.
  367.  
  368.              In later versions of DOS you can add:
  369.              Install=C:\dos\share.exe
  370.  
  371. AUTOEXEC.BAT    -    The auto execution file required for proper automatic
  372.              system startup. It will be necessary to add the time
  373.              environmental variable TZ to your AUTOEXEC.BAT ile.  This
  374.              variable is defined as your local time zone (PST, CST,
  375.              MST or EST), plus your offset in hrs from UTC (8,7,6,5),
  376.              plus an alternate daylight savings time name. It defaults
  377.              to PST8PDT so your parameters will depend on your location
  378.              in relation to UTC.
  379.  
  380. Add the following to this file:
  381.  
  382.              Share /L:30    If not loaded in config.sys
  383.              lm         Load the MailBox Lock Manager
  384.              bpqcode        Load the G8BPQ Switch
  385.              ytnc 20 2 1    Required for versions 4.05 or later of
  386.                     the BPQ Switch.
  387.              mbinit        Initialize the MailBox
  388.              dv         Load DesqView (if using it)
  389.  
  390.              Starting in Version 16.8 you may add environmental
  391.              variables to your autoexec.bat file to set the directory
  392.              where the different Mailbox files will reside.
  393.              The four variables are:
  394.              set TZ=PST8PDT (Default)
  395.              RLILOG    -    Directory where the log files will be put
  396.              RLITMP    -    Directory where the temp files will go.
  397.              RLIDB     -    Directory where the various database
  398.                     files go:
  399.                     BID.MB, LOGIN.MB, MAIL.MB and WP.MB
  400.              RLICFG    -    Directory where the configuration files
  401.                     go.
  402.                     CRON, DIRS, DIST, FTUSERS, FWD, HELP,                     INFO,  INIT,
  403.                     KEYS, MOTD, NEWUSER, PORTS, SERVER, TAG,
  404.                     TEXT and XLATE.MB
  405.  
  406.             In Autoexec.bat add:
  407.             set RLILOG=\logs
  408.             set RLITMP=\tmp
  409.             set RLIDB=\bbsdb
  410.             set RLICFG=\bbscfg
  411.  
  412.             Note: the above are examples and the directories that you
  413.             use will have to be created prior to running the system.
  414.  
  415. DISK CACHES
  416.  
  417. It is a good idea to run a disk cache on a your system as the MailBox can be
  418. quite disk intensive.  SMARTDRV, HYPERDISK, NORTON CACHE or other popular
  419.  
  420.                     (7)
  421. disk caches seem to work well.    If you enable "Delayed write" the system will
  422. speed up quite considerably.  Determining the cache size is at the discretion
  423. of the sysop.  A 1mb cache is probably a good size to use.  However, if you
  424. run a large system and have the available memory then a larger cache would
  425. be desirable for optimal processing.  The optimal cache size would be sum
  426. of the files that reside in the directory specified by RLIDB.
  427.  
  428. DESQVIEW AND WINDOW SIZES
  429.  
  430. The approximate window sizes in DesqView for the various programs are:
  431.  
  432.      FT        -    42k
  433.      RT        -    31k
  434.      MBUSER    -    63k
  435.      MBSYSOP   -    62k
  436.      MBLISTEN  -    27k
  437.      MBFWD     -    46k
  438.      MBSTAT    -    24k
  439.      MON       -    38k
  440.      NW        -    80k
  441.      SERVER    -    92k
  442.  
  443. UPGRADING FROM PREVIOUS VERSIONS
  444.  
  445. If you are upgrading from a previous version after version 16.0 you will need
  446. to copy the executable files into the directory where your executables are
  447. placed.  A general procedure is as follows:
  448.  
  449. 1.  Backup your system
  450. 2.  Create a temporary directory and copy the relase file into it.
  451. 3.  Execute the file that will expand the various files from the archieve.
  452.     (Normally named MB1608.exe indicating version 16.8)
  453. 4.  Move or copy the .EXE and .COM files into the directory where they
  454.     will reside (Except the release archieve file) as specified.
  455. 5.  Review the example *.mb files and read CHANGES.DOC for any changes that
  456.     have been made.  Pay special attention to CRON.MB, INIT.MB, XLATE.MB,
  457.     SERVER.MB, DIRS.MB, FWD.MB and TEXT.MB.  You will need to modify these
  458.     files as per section 6 below.
  459. 6.  In version 17.x INIT.MB, MOTD.MB, SERVER.MB, CRON.MB PORTS.mb and TEXT.MB
  460.     will require changes.
  461.     a.    INIT.MB will require the addition of the Desqview keys that call
  462.     the programs for the system.  Specifically you will be required to
  463.     add a toggle for the desqview extensions (YES/NO), the keys for the
  464.     reply message editor (SR command), send message command (SP,SB,ST),
  465.     the read message command program (R #), the key for MBLISTEN, MBFWD,
  466.     MBSYSOP and MBUSER executables.  In addition you will need to add the
  467.     special key section from text.mb (F, E and E or whatever function keys
  468.     that you have designated.) Note that there are only 3 instead of 4
  469.     entries here.  The wake up the mailbox key is no longer required.
  470.     b.    MOTD.MB will require the removal of any references to $A or $P.  These
  471.     are now obsolete.
  472.     c.    SERVER.MB will require that the keys defined for the servers be
  473.     inserted in place of the \path\program name.  LSTSRV server will
  474.     require the addition of H8 instead of 8. (See LSTSRV.DOC)
  475.     d.    CRON.MB will require the call to any batch or programs to be defined
  476.     as a DV key.  For instance, RUN BPQNODES.BAT>NUL can be replaced by RUN
  477.     S1 which is the example Desqview pif file included in the release.  If
  478.     this particular call is defined in DV as a direct call to BPQNODES.EXE
  479.  
  480.                     (8)
  481.     instead of the batch file the system can update the nodes table in
  482.     a 12k window instead of 70k required for the batch call.
  483.     e.    TEXT.MB will require the removal of and reference to $A and $P and
  484.     the special keys section.
  485.     f.    PORTS.MB will require the removal of the 3 console definition lines.
  486.     Console is now handled by MBSYSOP.EXE.    The lines defining the ports
  487.     for the TNC is now reduced to one (1) parameter script.  TNC is changed
  488.     to read SWITCH <X> <Y> <Z> where X = the letter of the mailbox port;
  489.     Y = the YTNC port number to start with; and Z = the number of ports
  490.     to use.  Example SWITCH B 2 9: Start with MB port B, COM port 2, with
  491.     9 ports.  The rest of the commands remain the same.  Delete any other
  492.     port scripts below except for non switch port definitions.
  493. 7.  Desqview will require the addition of the programs MBUSER.EXE, MBLISTEN.
  494.     EXE, MBSYSOP.EXE and MBFWD.EXE.  (See DESQVIEW AND WINDOW SIZES above and
  495.     the DESQVIEW section below for further information.)
  496.  
  497.     (NOTE: YOU WILL HAVE TO HAVE DESQVIEW VERSION 2.5 OR ABOVE TO RUN THIS
  498.     VERSION)
  499.  
  500. 8.  You will also will be required to add the program information for the
  501.     servers that you intend to run.  There are example .DVP files included
  502.     with the release that defines the keys and sizes. (S1-PIF.DVP - S7-PIF.DVP)
  503.     (See 3) Using the Included PIF files section in the Desqview section
  504.     below.)
  505. 9.  Delete the call to MB.EXE in the DV Open a program window.
  506. 10. Modify the program sizes to the suggested values above using the
  507.     Desqview Change a Program (CP)
  508. 11. You will be required to change or create a new Desqview script file
  509.     for calling the system on line.  There 3 methods for doing this.
  510.     Method 1 is to delete the file Desqview.DVS in the \DV directory and
  511.     creating a new file.  Method 2 is to attempt to write over the existing
  512.     DV script file using the DV learn function.  Method 3 is to modify the
  513.     existing script by using the Desqview Convert a Script program. (note:
  514.     you may have to add this program to the menu.)  Your script will need to
  515.     call at a minimum SERVER.EXE.  This will bring up SERVER.EXE, MBLISTEN.EXE,
  516.     MBSTAT.EXE and MBSYSOP.EXE.  Any additional programs such as MON.EXE,
  517.     FT.EXE and RT.EXE will have to be added to the script.
  518. 12. Make any changes to your system files that are required including
  519.     Config.sys and Autoexec.bat.  Config.sys will require that the STACKS=
  520.     parameter be changed to 9,256.  Ensure that the enviornmental variables
  521.     are set correctly and that there are no spaces between SET RLIXX= and
  522.     the path statement.  (SET RLIDB= C:\DB will not work)
  523. 13. Restart the computer and run CVTMB.EXE.  Then start the BBS.
  524.     (Note:  This may require you to stop the autoexec.bat processing after
  525.     mbinit has run run cvtmb.exe and then restart the system.)
  526.  
  527. If you are upgrading from 11.0 to version 15.8 follow the above procedure
  528. except that you will need to create CRON.MB and run SERVER.EXE in a newly
  529. created DesqView window.  SERVER.EXE will require a 92K window to run.
  530. In some cases you will also have to create KEYS.MB, DIST.MB, XLATE.MB,
  531. TEXT.MB and DIRS.MB.  If this is the case XLATE, TEXT and DIRS.MB are created
  532. from the old CONFIG.MB file.  Once these files have been created CONFIG.MB
  533. can be deleted.
  534.  
  535. If you are upgrading from a version previous to VERSION 11.0 you will need to
  536. convert your WP DATABASE before beginning the upgrade process.    Please follow
  537. this procedure:
  538.  
  539.  
  540.                     (9)
  541. 1.  From the MailBox prompt issue the command to dump your WP database to a
  542.     text file.
  543.     IA WP.TXT
  544. 2.  Bring down the system.
  545. 3.  Delete or rename your old WP Database.
  546.  
  547. Then  proceed with the procedures as outlined above.   After starting the
  548. system and it is up and running, from a DOS window issue the command:
  549.  
  550.      WPLOAD WP.TXT
  551.  
  552. This will read in your wp data to the new file format. Depending on the size
  553. of your WP file this could take some time.
  554.  
  555. If  anything  fails to run then review the above procedures.  Generally
  556. failure to run properly can be attributed to imporper window size in
  557. DesqView, additional or deleted lines in any of the configurable files
  558. (*.MB) or improper commands in PORTS or FWD.MB.
  559.  
  560. INSTALLING A NEW SYSTEM
  561.  
  562. If you are installing a new system then you will be required
  563. to do the following:
  564.  
  565. 1.  Create the \BBS under the root directory.
  566. 2.  Make a temporary directory and copy the release file into it and expand the
  567.     archieve file.
  568. 3.  Move or copy the executable files (*.COM and *.EXE) files into where
  569.     you intend for them to reside.
  570. 4.  Move or copy HELP.MB into the directory where you intend for it to reside.
  571. 5.  Move or copy the *.mb files into the directory where you intend for
  572.     them to reside or as defined by the environmental variable RLICFG.
  573. 6.  Modify or create TEXT.MB, XLATE.MB, DIRS.MB, FWD.MB, CRON.MB, INIT.MB,
  574.     KEYS.MB, DIST.MB, MOTD.MB, NEWUSER.MB, INFO.MB and PORTS.MB.
  575. 7.  Modify CONFIG.SYS and AUTOEXEC.BAT to support the MailBox.
  576. 8.  Place the G8BPQ switch code files in a separate directory under the root
  577.     directory.
  578. 9.  Modify the G8BPQ configuration file BPQCFG.TXT for your site and the
  579.     number of ports that you intend to use.  Then compile it using the
  580.     BPQCFG.EXE file.
  581. 10. Configure your TNC's to run in the KISS mode.
  582.     Note: Kantronics KPC-4 and KAM require Firmware version 2.85 or later.
  583.       TNC2 or clones should have firmware version 1.1.5 or later.
  584.       TNC1 should be run no faster than 4800 baud.
  585.     Note: See the various .SET files included with the release for more
  586.       information.
  587. 11. Once this is done then attempt to start the system.  If you have been
  588.     successfull the last thing that you should see is "MAILBOX INITIALIZED"
  589. 12. Bring up Desqview.
  590. 13. Create a program item for each part of the Mailbox you intend to run.
  591.     The minumum is SERVER.EXE.
  592.     (Note that sample .DVP files are provided.)
  593. 14. Close down the system using the SD command.
  594. 15. Create a Desqview Script to bring up the various Mailbox tasks in the
  595.     order you want to come up in with SERVER.EXE as the first task.
  596.     Then any other tasks that you may want to run.
  597.     Save your script file.  Modify autoexec.bat to call DV.BAT and restart
  598.     your system.
  599.  
  600.                     (10)
  601.  
  602. IN CASE OF A CRASH
  603.  
  604. If the system crashes, make sure that all mailbox tasks are shut down.    When
  605. you have assured that all is not running run the following files:
  606.  
  607.     c:\dos\Checkdsk /f
  608.     c:\bbs\recover.exe
  609.     c:\bbs\mbinit.exe
  610.  
  611. This will recover your data and ensure that there is not any data loss.
  612.  
  613. DESQVIEW AND QEMM
  614.  
  615. For Version 17.x it will be required to create PIF files for the various
  616. components of the system.  The PIF files are named in the format of
  617. XX-PIF.DVP where XX is the keys used to call the program from the Desqview
  618. open window menu.  Before creating the necessary .DVP files it will be
  619. necessary to setup Desqview to run the Mailbox.
  620.  
  621. NOTE: For version 17.x you will be required to have Desqview version 2.5 or
  622.       above.
  623.  
  624. 1) Using DESQview SETUP:
  625.  
  626.  Under performance:
  627.  
  628.   Set the swapping time slices:
  629.  
  630.   For 6 Mhz AT, try 6 foreground and 6 background.
  631.   For 25 Mhz 386/486, try 3 foreground and 3 background.
  632.  
  633.   Common Memory              40
  634.   Dos buffer for EMS             15
  635.   Optimize communications          N
  636.   Allow Swapping of programs          Y
  637.   Manage printer contention          N
  638.  
  639. Under Logical drives:
  640.  logical drives:           none
  641.  swap drives   :           none
  642.  
  643. Under video monitor:
  644.  video monitor :           for EGA use 3....CGA option for color
  645.                    gives maximum memory. Mono is the best for
  646.                    memory and yields the maximum conventional
  647.                    memory after optimization.
  648.   display text/graphics        Y if you want the screen blanker to work.
  649.   Monitor require sych access  N
  650.   Screen blanker           What ever is appropriate. If disp text graphics
  651.                    not set to y then it will not work.
  652.  
  653. 2) Setting Up the PIF Files
  654.  
  655. From the Desqview open window menu you will need to use the add a program
  656. portion of Desqview.  Enter the AP command, space to other and enter the
  657. space bar to select.  When the prompt for directory put in \mbexe and then
  658. <cr>.  Enter the information as outlined above for the first section, then
  659. F10 for the advanced options.
  660.                     (11)
  661.  
  662. A <CR> at this point will return you to the Add a Program menu.  Again go to
  663. other and enter the space bar.    Add all the programs necessary for the system
  664. including your text editor and all the server options that you intend to
  665. run.
  666.  
  667. Program Name:               MAILBOX: MBSYSOP.EXE
  668. Key to use on open menu:       MS           (Anything you like)
  669.  
  670. Note:  It is very benifical to use keys that approximate the program that
  671.        you are going to start.    This might require that some of the existing
  672.        keys be redefined.  For instance Desqview Manifest uses MF to call the
  673.        Manifest program.  Redefining this to another key sequence will allow
  674.        you to use MF to call MBFWD with the MF keys.
  675.  
  676. Memory Size (in K):           62  (or the appropriate size as defined
  677.                     previously)
  678. Program:               MBSYSOP.EXE
  679. Parameters:               (Leave this blank except where required)
  680. Directory:               C:\MBEXE        (Where you put your .EXE and
  681.                         .COM files.)
  682. Writes directly to screen:     N
  683. Displays graphics information: N
  684. Virtualize text/graphics       N
  685. Uses serial ports (Y,N,1,2)    N
  686. Requires floppy diskette:      N
  687.  
  688. ADVANCED OPTIONS: <F10>
  689. System Memory:               0
  690. Maximum Program Memory Size:
  691. Script Buffer Size:           1000
  692. Max Expanded Memory Size:
  693. Text Pages:               1
  694.  
  695. Te         indow s groZE andn: .mOB   omen
  696. D:@ ctoope Iopen  pr3Ween bla   1000
  697. Nd4Dk
  698. usly)d Me3Ween bthe editorludinneuffher cC$ Pageruhced oees: AgailCED OPTIO    key)
  699. pproxiDesqequire t (sting
  700. ─t you iDa8oryethef  o Lme redut SYSOP.EXEqequig Up ):           Whm
  701. ifical to use iMCcal to us portDrectory puæ Malikly)d Me3Ween bthe editorlex Expant Me3WeuDreRskt youaletsses  d.
  702. ou to tequire2  Pr1zgIONS: <F1it so(st1d Me1Ofnded E iDt       Ped no COM filihe eNote:atmn menou like)tssesed Ema           1000
  703. Max Expanded Memory uyou to t.ogr8eysOB  lnpanktDa8B and i.    Add aIAoIe iMCcal to us portDr'uDreRlaifical to Puessa├ffe: gailpUse2y)      yBd    Seuffhr that
  704.        you are going to start.    This might    equto Pue1d aare gystes: AgN
  705. Usesrt.    Thisys usebnEHlhat
  706. it1bYSOoThisysN
  707. USize:
  708. Script BÆical e
  709. foreis bltDa8BScritartED equirou oy)
  710. Prondedu likeNdCcal]oope c ou ppficfartED rt.    TSRrt.    Mto ^lED rtlike)tIkeyclTmm    pfiSaPages: oy)   U us porop sbuig Up ):tarrtoryl oyOPoesqeqryeIadBg
  711.  e a╦sa├ADVAN[Wo Mblank exc       ED o╞)   rupnlank exc    callo
  712. eis blt dinneuffher cC$ Pageruhced oees: AgailCED OPTIO    key)ou amight cC$ s             iht cC$ 1Çiëesrt.    iiMCr1zg cO    62  (orEXE
  713. Pasys u s    ut/gJhat
  714.        yeceroReZ2dThisy    iht cC$ 1Çiëesrt.Wusly)rogrora   1000to ^tooboarForForAasys u s    urARe
  715. PrEXErhisy    ier8eyse thi
  716. to ^taecns: AgailCf    ire tiëesrtratDrectorpRty    ier
  717. logram MTexxxx. lo    u s    ut/gJm u s    ut/gJukt  i.    Ad flophieRaysandequire2  @sys u s    utDteight cC$ s          a1eaSher c
  718. D:uyDesqequire t (sting
  719. ─t you iDa8oryethef  o Lme re,2taect    m1t (Dllo
  720. e8mpúvkVeTOPoes    a8oryethef u s    urARe
  721. ly)rogrorarsc
  722. e8 exc       ED o╞)   8or   ie(mctorpRty  oses:orlt (m cCYhisys usebnEHlhanO  cC$ (íi.    Add s grlF2fpCcal]oope cSsxUe8ailCADVAN[Wo Mlllllllllll
  723.      iht cC$ ëVuse iMSLC$ sforAasysto ^taecns: AgailCf    ire tiëesrtraRwfic 
  724. c LFnneuffher cC$r.ht cCIize: m1t lht din MoFireouaasseEript   Pr1Poes   roRe cC$ (pUs1  ot cCor   fari (pp pe a5a5apcsuhced oeeaSherinneDToe c(utohef u qequKPBφ  n│
  725. eiPTsxUe8ailCre goPdis    urARe
  726. lymc 
  727. c LF
  728. c me    $ ëVussxUeisys ailCrC
  729. UsesIip (orEeect"  $ly)/EX
  730.